/*
 * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
 * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */

package java.io;


/**
 * public interface Serializable类的序列化由实现java.io.Serializable接口的类启用。
 *
 * 不实现此接口的类将不会使任何状态序列化或反序列化。
 * 可序列化类的所有子类型都是可序列化的。
 * 序列化接口没有方法或字段，仅用于标识可串行化的语义。
 * 为了允许序列化不可序列化的子类型，子类型可能承担保存和恢复超类型的公共，受保护和（如果可访问）包字段的状态的责任。 子类型可以承担此责任，只有当它扩展的类具有可访问的无参数构造函数来初始化类的状态。 如果不是这样，声明一个类Serializable是一个错误。 错误将在运行时检测到。
 *
 * 在反序列化期间，非可序列化类的字段将使用该类的public或protected no-arg构造函数进行初始化。 对于可序列化的子类，必须可以访问no-arg构造函数。 可序列化子类的字段将从流中恢复。
 *
 * 当遍历图形时，可能会遇到不支持Serializable接口的对象。 在这种情况下，将抛出NotSerializableException，并将标识不可序列化对象的类。
 *
 * 在序列化和反序列化过程中需要特殊处理的类必须采用具有这些精确签名的特殊方法：
 *
 *   private void writeObject(java.io.ObjectOutputStream out)
 *      throws IOException
 *  private void readObject(java.io.ObjectInputStream in)
 *      throws IOException, ClassNotFoundException;
 *  private void readObjectNoData()
 *      throws ObjectStreamException; writeObject方法负责为其特定的类编写对象的状态，以便相应的readObject方法可以恢复它。 可以通过调用out.defaultWriteObject来调用保存对象字段的默认机制。 该方法不需要关注属于其超类或子类的状态。 通过使用writeObject方法或通过使用DataOutput支持的原始数据类型的方法将各个字段写入ObjectOutputStream来保存状态。
 *
 * readObject方法负责从流中读取并恢复类字段。 它可以调用in.defaultReadObject来调用恢复对象的非静态和非瞬态字段的默认机制。 defaultReadObject方法使用流中的信息将保存在流中的对象的字段分配给当前对象中相应命名的字段。 当处理类进化到添加新字段时，这将处理这种情况。 该方法不需要关注属于其超类或子类的状态。 通过使用writeObject方法或通过使用DataOutput支持的原始数据类型的方法将各个字段写入ObjectOutputStream来保存状态。
 *
 * 如果序列化流未将给定类列为反序列化对象的超类，则readObjectNoData方法负责初始化其特定类的对象的状态。 这可能发生在接收方使用与发送方不同的反序列化实例的类的版本的情况下，并且接收者的版本扩展了不被发送者版本扩展的类。 如果序列化流已被篡改，也可能发生这种情况; 因此，尽管存在“敌对”或不完整的源流，readObjectNoData可用于正确初始化反序列化对象。
 *
 * 在将对象写入到流中时需要指定要使用的替代对象的可序列化类应实现具有确切签名的特殊方法：
 *
 *   ANY-ACCESS-MODIFIER Object writeReplace() throws ObjectStreamException; 如果该方法存在并且可以通过在被序列化的对象的类中定义的方法来访问，则该writeReplace方法通过序列化来调用。 因此，该方法可以具有私有，受保护和包私有访问。 子类访问此方法遵循java可访问性规则。
 *
 * 当从流中读取实例时需要指定替换的类应实现具有确切签名的特殊方法。
 *
 *   ANY-ACCESS-MODIFIER Object readResolve() throws ObjectStreamException; 这个readResolve方法遵循与writeReplace相同的调用规则和可访问性规则。
 *
 * 序列化运行时将每个可序列化的类与称为serialVersionUID的版本号相关联，该序列号在反序列化期间用于验证序列化对象的发送者和接收者是否已加载与该序列化兼容的对象的类。 如果接收方加载了一个具有不同于相应发件人类的serialVersionUID的对象的类，则反序列化将导致InvalidClassException 。 一个可序列化的类可以通过声明一个名为"serialVersionUID"的字段来显式地声明它自己的serialVersionUID，该字段必须是静态的，最终的，类型是long ：
 *
 *   ANY-ACCESS-MODIFIER static final long serialVersionUID = 42L; 如果可序列化类没有显式声明serialVersionUID，则序列化运行时将根据Java（TM）对象序列化规范中所述的类的各个方面计算该类的默认serialVersionUID值。 但是， 强烈建议所有可序列化的类都明确声明serialVersionUID值，因为默认的serialVersionUID计算对类详细信息非常敏感，这可能会因编译器实现而异，因此可能会在反InvalidClassException化期间导致InvalidClassException的InvalidClassException。 因此，为了保证不同Java编译器实现之间的一致的serialVersionUID值，一个可序列化的类必须声明一个显式的serialVersionUID值。 还强烈建议，显式的serialVersionUID声明在可能的情况下使用private修饰符，因为这种声明仅适用于立即声明的类 - serialVersionUID字段作为继承成员无效。 数组类不能声明一个显式的serialVersionUID，所以它们总是具有默认的计算值，但是对于数组类，放弃了匹配serialVersionUID值的要求。
 */

/**
 * @author  unascribed
 * @see java.io.ObjectOutputStream
 * @see java.io.ObjectInputStream
 * @see java.io.ObjectOutput
 * @see java.io.ObjectInput
 * @see java.io.Externalizable
 * @since   JDK1.1
 */
public interface Serializable {
}
